Sets the color of an individual pixel to the color that most closely matches the RGB color that you specify in the cPix parameter.

void SetCPixel (
    SInt16 h, 
    SInt16 v, 
    const RGBColor *cPix
);

h

The horizontal coordinate of the point at the upper-left corner of the pixel.

v

The vertical coordinate of the point at the upper-left corner of the pixel.

cPix

An RGBColor structure.

DISCUSSION

On an indexed color system, the SetCPixel function sets the pixel value to the index of the best-matching color in the current device’s CLUT. In a direct environment, the SetCPixel function sets the pixel value to a 16-bit or 32-bit direct pixel value.

To determine the color of an individual pixel, use the GetCPixel function.

SPECIAL CONSIDERATIONS

The SetCPixel function may move or purge memory blocks in the application heap; do not call this function at interrupt time.

AVAILABILITY

Supported in Carbon. Available in CarbonLib 1.0 and later when InterfaceLib 7.1 or later is installed. Exported by CarbonLib 1.0 and later and by InterfaceLib 7.1 and later.

© 2000 Apple Computer, Inc. — (Last Updated 4/14/2000)